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Db Ject i ves of Module 

In this nodule you will learn how to use special 
built-in features of the Atari CoMputer that allow you to Mix 
different graphics Modes on one screen* You will explore how 
to create your own display lists # how to organize screen RAM, 
and how to use this knowledge to Make screen iMages exactly 
the way you want theM* 



Overview ( sub top ics ) 



1 ♦ Purpose of a Display List* 

Relationship between display lists and graphics Modes* 
Display list instructions* 

2* What is Screen RAM? 

Relationship between display lists* screen RAM* 
and graphics Modes* 

How to put inforMation into screen RAM* 

3* CustoMized Display Lists* 

What are scan lines and Mode lines? 
CoMbining different Mode lines* 
Organizing and using screen RAM* 

^t* SuMM3ry and Challenges* 



Prerequisite Understanding Necessary 

1* You Must be faMiliar with how to individually use 
different BASIC graphics Modes to put text or graphics on 
your screen* 

2* You Must know the purpose of the PEEK and POKE stateMents 
and how to use theM in BASIC* 

Mater ials Needed 



1« BASIC Cartridge* 

2* Advanced Topics Diskette. 
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In this section you will learn what 3 display list is 
and how to use 3 display list to specify different graphics 
wodes on the screen ♦ 



The Atari Computer is extremely vers3tile* It can print 
information on the screen in m3ny different wsys* When you 
first sit down at the computer * you see the screen displays 
text in smsll letters — this is gr3phics node 0* You can, 
however* choose to have text printed in larger characters 
(graphics modes 1 and 2)* or you can draw pictures on the 
screen using other graphics modes* 



If you are using the BASIC language* you can tell the 
computer how to display information on the screen by using 
the GRAPHICS #n command* Thus* if you say "GRAPHICS 3"* the 
computer knows that it should only show lighted spots 
(pixels) of up to 4 different colors (if you count the 
background color) on the screen* The computer must do a 
great deal of work between the instant you type "GRAPHICS 3" 
and when the screen is ready to be used for plotting and 
drawing colors* Luckily* BASIC does all of this hard work 
for you* In fact* one might ssy thst BASIC simply hands to 
the Antic chip an entire display list (whatever that is) 
ready for use* Without this display list* the computer 
wouldn't function* 



In Diagram #1 you can see that a display list is simply 
a list of numbers* Soon we'll discuss what these numbers 
mean* First* let's see what kinds of display lists BASIC 
creates for the various graphics modes* To obtain this list 
using BASIC* you can tell the computer to go into a 
particular graphics mode* then save the numbers from a place 
in memory where the display list is stored* and* finally* 
return to Graphics 0 and print these numbers out on the 
screen* The program below accomplishes this task* Type RUN 
"DJDLIST" ♦ Then use this program to answer the questions on 
Display List Worksheet #1* 
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100 REM x PrograM DLIST 

110 REM * 

120 DIM DLIST ( 250 ) i DIM SPLIT* <1> 

130 GRAPHICS 0 

140 PRINT "I will show you the Display List" 

150 PRINT "of any graphics Mode*" 

160 PRINT.PRINT "Which Mode (0 - ll)"j:iNPUT MODE 

170 IF MODE=0 OR M0DE>8 THEN 20 0 

180 PRINT "Split screen (Y or N>" J. INPUT SPLITS 

190 IF SPLITS<>"Y" THEN M0DE=MQDE+16 

20 0 GRAPHICS MODE 

210 REM x 

220 REM x Calculate the nenory location 

230 REM x of the display list. 

240 REM * 

250 LBYTE=PEEK(560).HBYTE=PEEK<561> JL0C=LBYTE+256xHBYTE 

260 COUNT=0 

27 0 DLIST ( COUNT ) =PEEK ( LOC+COUNT ) 

280 REM x 

290 REM x The next stateMent deterMines if we are 

300 REM x at the end of the display list* 

310 REM x 

320 IF PEEK(L0C-C0UNT-2)<>65 THEN CQUNT=C0UNT+1 : GOTO 270 

330 GRAPHICS 0 J SPACE=INT (40/ < 1+INT < COUNT/21 ) ) ) 

340 FOR 1=0 TO COUNT 

350 POSITION SPACExINT<I/21)+l,I-2lxlNT(I/21 ) 

360 PRINT DLIST (I) i 

370 NEXT I 

380 POSITION 2, 21. GOTO 160 



DiagraM 1 
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Display List Worksheet -*1 



When you use 3 split screen graphics Mode, the top 
portion of the screen uses one graphics Mode while the bottoM 
four rows use Graphics 0* In fact, it is possible to divide 
a screen into Many More pieces, or rows, and Make each row, 
or coMbination of rows, a different graphics Mode* 



The nuMbers in a display list each have a Meaning, but 
you will notice that Most of the nunbers in any display list 
are all the saMe* The nuMber which appears Most often tells 
the coMputer which graphics Mode each horizontal line on the 
screen represents* You will also notice that this Most 
frequently used number is a different nunber froM the one 
used to tell BASIC what graphics Mode you want* The nuMbers 
used in display lists are called Antic Mode nuMbers* 



Use the DLIST prograM to find the Antic Modes for each 
BASIC Mode below* Be sure to ask for full screen and not 
split screen Modes* For BASIC Modes 0 through 3, count how 
Many tiMes the Antic Mode nunber appears in the display list* 
(Ask for help if you are confused)* 



BASIC Mode 


|0|1-|2| 


<2 1 


4 1 


5 | 


6 | 


7|3| 


Antic Mode 1 1 1 1 1 1 1 1 1 1 


NuMber of tiMes 


1 1 1 1 


1 










NuMber of lines of 
text or graphics 
on 3 full screen 


1 












1 

1 241 24 | 12! 


2-1 1 


48 | 


48 I 


96 | 


96| 1921 



Now look at the display lists for the split screen Modes* 
Which Antic Mode appears at the end of these lists (it 

appears ^th* 5th, and 6th froM the end)? 

Which BASIC Mode does this correspond to? 

How Many tiMes does it appear? 

Recall that we always get 1 text lines in our split screen 
window ♦ 
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You are probably wondering why we always seen to be 
short by one when we count the number of tines each Antic 
Mode nuflber appears 4 The Missing Mode nuMber is really 
there* but it is hidden froM us* Look at the display list 
for graphics Mode 3* split screen* The fourth nuMber in the 
list is 72* If we subtract 64 (64 is a special nuMber we'll 
explore later)* we get 72-64 « 8* Aha! — An extra 8* Now 
look at the end of the list of S's just before we switch to 
2* You see the nuMber 66* Again* if we subtract 64* we get 
66-64 = 2* There's our Missing 2* Look again at soMe other 
graphics Modes and be sure you can find the Missing Antic 
Mode nuMbers* 
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In this section you will learn how the computer knows 
where to store and retrieve information it puts on your 
screen ♦ You will explore how to change what you see on the 
screen by directly changing what is stored in memory* 



Diagram 2 




The display list not only tells the Antic chip what kind 
of information to put on the screen (small text* large text, 
graphics) , but also tells Antic where to find the information 
that is going to go on the screen* When you tell BASIC to 
PRINT "Hello", BASIC puts the word "Hello" in a particular 
place in computer memory, and Antic knows just where to find 
it so that it can copy it onto the screen (see Diagram 2)* 
Antic knows where to find it because the display list tells 
it where to look* The portion of memory where Antic looks to 
get information to display on the screen is called screen RAM 
(Random Access Memory)* 
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Remember that special number 64 which helped to hide one 
of our Antic mode numbers? Look at the Graphics 0 display 
list in Diagram 2* The fourth number is 66 which is 64+2* 
That's our one missing Antic mode 2 (BASIC mode 0) number* 
The 64 has the special meaning of telling the Antic chip that 
the next two numbers tell where the screen RAM starts* Those 
numbers are 64 and 156* To get the starting location of 
screen RAM we always multiply the second number by 256 and 
add the first* Thus* screen RAM starts at 256x156 + 64 = 
40000* Thus* memory locations beginning at 40000 (and* in 
the case of Graphics 0* ending at 40959) are used to save 
information that will appear on the screen* (Warning* 40000 
is the beginning of screen RAM for Graphics 0 only* 
Different numbers appear in the different display lists for 
other graphics modes)* 



Take the time now to do Display List Worksheet *2* 
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Display List Worksheet *2 



By playing 3 little with PEEKs and PQKEs* you can do 
sone interesting things to screen RAM to Make interesting 
things happen on the screen* Start by following these steps* 

1* Press SHIFT-CLEAR to clear the screen* The cursor should 
he positioned at the top of the screen* It will be 
automatical ly positioned two spaces in from the left-most 
edge ♦ 

2* Dn this top line type your name* Don't press RETURN ♦ 
Use the arrow keys to Move the cursor down a couple of lines 
and to the left Margin (2 spaces in from the screen edge)* 

3* Be sure you are in the capital letters node by pressing 
SHIFT-CAPS ♦ Now type: LOC=^0000 and press RETURN* LQC 
contains the starting address of screen RAM* 

^* The first two locations in screen RAM are blank because 
your name is indented by two spaces* Thus if you type: 
PRINT PEEK ( LQC > t PEEK ( LOC+1 ) you will see two zeros* 

5* Try typing the following (always press RETURN after each 
line ) ♦ 

PRINT PEEK ( LOC+2 ) , PEEK ( LQC+3 > 
POKE LOC+20 * PEEK ( LOC + 2 ) 

(Notice what happens on the top line)* 

POKE LOC-MO *PEEK(L0C+3) 

6* Play with the ideas above for a while to explore the 
possibilities* For example* try things like: 
POKE L0C+4Q,1£5« Try other numbers* 



You can also explore screen RAM in other graphics modes* 
but first you need to find out where screen RAM is located 
after you enter the graphics mode* Type the following 
exactly as shown below (no line numbers): 

GRAPHICS 3 

DLIST=256*PEEK (561) +PEEK ( 56 0 ) 

(This is the location in memory of the display list)* 
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LQC=256*PEEK ( DLIST+5 ) +PEEK ( DLIST M ) 



(Here we use the two nuMbers in the display list which 
tell us where screen RAM begins)* 



Mow try sone of the following and then experiment on your 
own ♦ 

POKE L0C255 
POKE LOG f 39 

FOR 1=0 TO 255 SPOKE L0C,i:F0R J=i TO 3 0 ♦ NEXT J ♦ NEXT I 
FOR 1=0 TO 255 SPOKE LQC+X».X!.FOR J-i TO 20 ♦ NEXT JJNEXT I 



If you are interested in understanding how the coMputer 
uses the number in screen RAM to decide what colors to put on 
the screen f you should study the advanced Module on "Internal 
Representation of Text and Graphics" ♦ 
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You can also put information onto the screen by letting 
BASIC do it for you* which is* of course * much easier* When 
you use the standard graphics modes you don't need to do 
anything special* you just use standard BASIC statements like 
PLOT, DRAWTO* PRINT *6* etc* 



However* when you construct your own display lists* you 
have to do some special things before you can use BASIC 
statements to draw or print things on the screen* The two 
crucial pieces of information you need for BASIC are* 1) the 
graphics mode in which BASIC should assume you are working 
(it will be different for different rows on the screen)* and 
2) the location in memory that BASIC should consider the 
beginning of screen RAM for that particular portion of the 
screen* 



Diagram 3 




These locations can be 
arbitrarilly chosen so long as 
they point to free areas in 
memory* 
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For example* if you have 3 screen with Graphics 2* 
Graphics 3* and Graphics 0 on it* you need three separate 
pieces of memory where the information for each portion of 
the screen can be stored (see Diagram 3)* Now* if you want 
to put something into your Graphics 3 area on the screen* you 
can put numbers directly into screen RAM (starting at 
location 40800 in this example) as we did earlier ♦ Or* you 
can use BASIC PLOT and. DRAWTO statements (much easier) by 
first telling BASIC that you are working in Graphics 3 and 
that screen RAM starts at location 40800* Then* for example* 
if you say PLOT 0*0 you will get a colored point at the 
position marked by the arrow ( — >) to the left of the 
diagram* To see how this all works* follow the instructions 
on Display List Worksheet #3* 
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Display List Worksheet #3 



The first thing we are going to do is create a display 
list with Graphics 2 at the top of the screen, then Graphics 
3, and finally Graphics 0* For now, there will he little 
explanation of how we create this new display list* (You 
will learn More about how to do this in the next section*) 
In this section, you will be concentrating on how to get 
BASIC to print to different Modes on different portions of 
the screen* 



We will start with a Graphics 3 (split screen) display 
list and Modify it by putting Graphics 2 at the top* The 
standard Graphics 3 display list and the Modified version 
that we want to create are shown below { 

GR* 3 112 112 112 72 112 153 8 8 8 8 8 8 8 ♦♦ 

Modified 112 112 112 71 112 158 7 7 72 172 158 8 8 ♦* 



The following prograM will create the Modified display 
list* Type it in and run it* 

10 DIM A (10) 

20 GR* 3 

30 DLIST=256>:<PEEK(561 ) +PEEK ( 560 ) 

^0 FOR 1=0 TO 5 

50 A(I)«PEEK<DLIST+I) 

60 NEXT I 

7 0 A ( 3 ) =71 ♦ A ( 6 ) =7 ♦ A ( 7 ) =7 J A ( 8 ) =72 t A ( 9 ) = 172 I A (10) = 153 

8 0 FOR 1=0 TO 10 J POKE DLIST+I * A ( I ) t NEXT I 
90 END 



Now let's be sure we really have both Graphics 2 and 
Graphics 3 on our screen* Try the following! 

LQC=158tt256 + :L12 (This is screen RAM for Graphics 2) 
POKE LOG ♦ 33 (33 is the code for "A") 

POKE LOC+2 0,3^ 
POKE LOC-M0>35 

Hopefully, "A"* M B M * and M C n showed up in Graphics 2* 
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Try POKEing other nuwbers into screen RAM* Then try J 

LOC=LOC+60 (Now LOG is the address of 

POKE LOG , 255 Graphics 3 RAM) 

POKE L0C,75 

Hopefully* some blocks of light showed up in Graphics 3* 



Now let's see about the bottom part of the screen* 

L0C=159*256+96 

(Press SHIFT-CLEAR so that the cursor is at the top of 
the window to prevent the window from scrolling*) 

POKE L0C,33 



Now let's try to get BASIC to do sows of the work* 
POKE 87 , 2 

(In location 87 we POKE the graphics Mode we want BASIC 
to think we're using)* 

POKE 83, 112 J POKE 89*158 

(Locations 88 and 89 are used to store the two numbers 
which point to screen RAM* Now we can use regular BASIC 
statements ) ♦ 

PRINT #6J n your nan©" 
POSITION 10,0 
PRINT #6: "WOW" 

(Switch to Graphics 3 area)* 

POKE 87,3 

POKE 88 ♦ 172 ♦ POKE 89,158 

(The numbers 172 and 158 are the two numbers which 
define the starting location of the Graphics 3 RAM* The 
actual location in memory is lS8Xx56+172) * 

COLOR 1 

plot o,o:drawto 10,0 
color 2jdrawt0 10 , 10 
color 3 jdr awto 0,10 
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Just for the fun of it* tr*j the following t 
POKE 87,2 

(BASIC now thinks we're in Mode 2 f but we're still 
pointing to Graphics Mode 3 RAM)* 

POSITION 0,0 

PRINT #6 J "your nane" 

Experi Merit with this for 3 while* 
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In this section you will learn about scan lines and Mode 
lines so that you can design your own display lists* You 
will also learn about organizing and addressing nenory so 
that you can use your display lists* 



Depending on which graphics node you are using* you can 
have a different number of lines of information on the 
screen* For example* in Graphics 0 you can have 24 lines 
(rows) of text* We call each of these lines a mode line * In 
GRAPHICS 2* you can only fit 12 lines of text on the screen* 
Graphics 2 has 12 mode lines per full screen* 



Each node line has a certain width (perhaps easier to 
think of as a height) to it* Graphics 0 mode lines are 
thinner than Graphics 2 mode lines* In fact* they are twice 
as thin* which is why you can get twice as many lines on a 
full screen in Graphics 0* We count the thickness of node 
lines in terns of a fixed width called a scan line ♦ A 
Graphics 0 node line has 8 scan lines while a Graphics 2 node 
line has 16 scan lines (twice as thick)* 



The entire screen can hold up to 192 scan lines* but no 
nore* Since each Graphics 0 line has 8 scan lines* you can 
have 192/8 * 24 node lines on the screen in Graphics 0* In 
contrast* each Graphics 7 node line uses up only 2 scan 
lines* Thus you get 192/2 = 96 Graphics node 7 lines on one 
screen* (See chart at end of this section* "Antic and the 
Display List" ) ♦ 



When you construct your own display list* you nust keep 
count of how nany scan lines you are using and be sure not to 
go over 192* 



In the previous section you learned that there needs to 
be screen RAM devoted to each portion of the screen* 
Depending on which graphics node you use* each node line uses 
up a different amount of nenory* MeMory is counted by 
counting things called bytes* The "Antic and the Display 
List" chart shows how nany bytes are used up by each node 
line* For exanple* it takes 40 bytes for each Graphics 0 
node line* If you want a full screen of Graphics 0* it takes 
24 node lines x 40 bytes for each node line = 960 bytes of 
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Memory ♦ 



To help you understand all of this better , take the time 
to do Display List Worksheet *4 now* 
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Display List Worksheet #^ 



For each of the following screen displays, fill in the 
numbers where a blank exists* All graphics Modes are printed 
as BASIC ♦ not Antic ♦ Modes* You'll need to use the "Antic 
and the Display List" chart* You'll also need to use the 
fact that a full screen has 192 scan lines ♦ 



GR ♦ 0 



GR ♦ 3 



8 Mode lines 
(6^ scan lines) 



Mode lines 

(128 scan lines) 



320 bytes RAM needed 



bytes RAM needed 



GR* 



GR* 3 



Mode lines 



14 Mode lines 



10 0 bytes RAM needed 



1^0 bytes RAM needed 



3, 


/ GR» 


7 




Mode 


1 ines 


bytes 


RAM 


needed 




^ GR. 


1 / 


' 4 


Mode 


1 ines 


bytes 


RAM 


needed 






















1 GR . 


,.,:.\ 


2 


Mode 


1 i nes 


bytes 


RAM 


needed 




GR. 


5 




Mode 


1 ines 


bytes 


RAM 


needed 




i GR . 


-o j 


ry 
£, 


Mode 


1 i nes 


bytes 


RAM 


needed 
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It's finally tiMe to Make your own display list* Let's 
use problem 4 on worksheet #4 as an exaMple* If you 
correctly solved the problem, you should have the following: 



We always begin our display list with 112 112 112* 
Each of these numbers tells Antic to skip 8 blank lines for 
total of 24 scan lines* We need to skip these because they 
are above the visible screen — this is called overscan* but 
all you need to worry about is that you always start your 
display list this way* 



You Must decide where in MeMory to begin your screen 
RAM • You need a total of 40 + 720 + 80 ~ 840 bytes* Next 
calculate how many pages of Memory you need (1 page - 256 
bytes)* Thus 840/256 = 3 + extra* So* 4 pages of MeMory 
will hold all of screen RAM* It is customary to put screen 
RAM near the end of Memory* Calculate backwards froM 159 
pages (on a 48K Machine) — 159 - 4 pages ~ 155 pages* This 
calculation shows that screen RAM should begin on the first 
byte (called byte 0) on page 155* This pair of nuMbers (0* 
155) is called a Memory address ♦ We say the low byte is 0 
and the high byte is 155* 



The first graphics Mode is BASIC Mode 2* but you Must 
always use the Antic Mode nuMber which is 7 in this exaMple* 
The display list Must tell the coMputer that there is an 
Antic Mode 7 line and it Must also signal that the next two 
nuMbers are the address of screen RAM (low byte* then high 
byte)* You May recall that this is done by adding 64 to the 
Antic code* So now we have ♦♦♦ 




2 Mode lines 40 bytes RAM needed 

(2 x 20 bytes per Mode line ~ 40) 



GR * 5 



36 Mode lines 720 bytes RAM needed 

(36 x 20 bytes per Mode line = 720) 




2 Mode lines 80 bytes RAM needed 

(2 x 40 bytes per Mode line =80) 
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112 
112 
112 

71 71 ~ 64 + 7* The first Antic Mode 7 line 

0 followed by the two numbers addressing 

155 screen RAM* 

7 7 is the second Antic node 7 line* 



So above the two Mode lines of BASIC Mode 2 are defined 
in the display list* To continue* you Must change to BASIC 
Mode 5 (Antic Mode 10 )♦ First* calculate where screen RAM 
will start* Let's put it after screen RAM for the Graphics 2 
lines* Since Graphics 2 RAM starts at byte 0 on page 155 and 
it uses up 40 bytes, you can start Graphics 5 RAM at byte 40 
on page 155* So we have ♦♦♦ 

112 
112 
112 
71 
0 

155 
7 

74 74 ~ 64 + 10* The first Antic Mode 10 

40 (BASIC Mode 5) line followed by 

155 the screen RAM address* 

10 . 

10 Here you need 35 More 10 's to specify the 

10 reMainder of the 36 Antic Mode 10 lines* 



Now where should your Graphics 0 (Antic Mode 2) screen 
RAM begin? For Graphics 5, you started at byte 40 on page 
155 and used up 720 More bytes* 

40 + 720 - 760 bytes* 

760/256 ■ 2 pages with 248 bytes extra* 

So the starting address is byte 248 on page 155+2 = 157* 

Now we have ♦ ♦ ♦ 

112 
112 
112 
71 
0 

155 
7 



Copyright Atari, Inc* 1933* All rights reserved* 

19 



74 
40 
155 

10 You need 35 tens* 

10 

♦ 

10 

66 66 = 64 + 2* The first Antic Mode 2 line* 

248 
157 

2 The second (l3st) Mode 2 line* 

65 Below is an explanation of 

0 - these last three numbers* 
159 



The third fro* last nuMber in the display list is always 
65 which is always followed by another address* This last 
address (0, 159) is where you decide to actually place the 
display list itself* You can fit it on page 159 as long as 
there are no More than 255 nuMbers in the display list* 



The reMarks on the following prograM provide you with 
the necessary explanations to put your display list into 
MeMory and use it* This prograM is stored in a file called 
"EXAMPLE* DLS" ♦ The reMarks are for your own understanding* 
so study theM carefully* Then try running the prograM* 



100 REM * Start with a GRAPHICS 0 stateMent or BASIC gets 

110 REM * confused when you try to print to your custoM 

120 REM * display list* 

130 REM * 

140 GRAPHICS 0 

150 REM * 

160 REM * This next stateMent turns off the screen* When 

170 REM * changing display lists, it's a good idea to turn 

180 REM * off the screen while you Make the changes* 

190 REM * 

20 0 POKE 559*0 

210 REM * 

220 REM * This is the location where we are going to put 

230 REM * our display list* 

240 REM * 

250 DLIST»2S6xl59 

260 REM * 
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270 REM * The next lines POKE our display list into neMory 

280 REM * on page 159 ♦ 

290 REM x 

30 0 FOR 1=0 TO 51 

310 READ CODE* POKE DLIST+I , CODE 

320 NEXT I 

330 DATA 112,112,112,71,0,155,7,74,40,155 

340 DATA 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10 
350 DATA 10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10,10 
360 DATA 66,243,157,2,65,0,159 
370 REM * 

380 REM x Next we need to clear screen RAM with zeros* 

390 REM * 

400 FOR 1=155x256 TO 159x256-1 
410 POKE 1,0 
420 NEXT I 
430 REM x 

440 REM x These POKEs tell the coiiputer where our display 

450 REM x list is located in Mewory. We POKE the two 

460 REM x nuMbers of our address into locations 560 and 561 ♦ 

470 REM x 

480 POKE 560,0. POKE 561,159 
490 REM x 

50 0 REM x Turn the screen back on* 

510 REM x 

520 POKE 559,34 

530 REM X 

540 REM x We'll use GRAPHICS 2 first* 

550 REM x 
560 POKE 87,2 
570 REM x 

580 REM x And we POKE the beginning address of GR ♦ 2 RAM* 

590 REM x 

60 0 POKE 88,0 {POKE 89,155 
610 PRINT #6 J" WOW! " 
620 PRINT *6," this is neat" 
630 REM x 

640 REM x Let's use GRAPHICS 0 now and tell BASIC where 

650 REM x screen RAM begins for this Mode. 

660 REM x 
670 POKE 87,0 

680 POKE 88, 248t POKE 89,157 
690 POSITION 2, 0: PRINT "My very own" 
70 0 PRINT "CustoM Display Screen*" 
710 REM x 

720 REM x And finally, GRAPHICS 5. 

730 REM x 
740 POKE 87,5 

750 POKE 88,40 : POKE 89,155 
760 COLOR 1 J PLOT Q,0.DRAWTQ 79,35 
770 COLOR 2 J PLOT 79,0.DRAWTO 0,35 
780 GOTO 780 
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Important Display List Memory Locations 



560* 561 Low byte, high byte address of where display list 

is located in Memory* BASIC supplies these numbers 
when it creates a display list* If you create one* 
you must indicate its location in these bytes* 

87 POKE with a 0 through 8* Tells BASIC what 

graphics mode you're working in* 

88* 89 Low byte* high byte address of screen RAM that 
BASIC uses when printing and plotting* 



Caution! There are some special cases (especially when you 
use GRAPHICS 8) in which screen RAM uses so much memory that 
a special code must be placed in the display list for it to 
work* This happens when screen RAM crosses a special 
boundary in memory called a 4K boundary* These boundaries 
occur at page 144* page 128* page 112* and at subsequent 16 
page intervals* You need not worry about this if these 
boundaries never show up in the middle of your screen RAM ♦ 
If this is unavoidable* refer to Your Atari Computer by 
Poole, McNiff and Cook on pages 30 0 - 301* 



Finally* you should be aware that there is no reason to 
do all of the hard work that is required every time you want 
to implement your own display list* Software exists that 
does all of the calculating and memory management for you* 
leaving you free to devote your efforts to creating 
interesting screen images* You may wish to explore "SCREEN 
MAKER" by Wayne Harvey to see how such a tool can save you 
time and trouble* 



As a final challenge* try to design an interesting title 
screen for some type of program (a game or other project)* 
Start by laying out your screen image on paper and then 
create the necessary display list* Finally* write a BASIC 
program to finish the task* 
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Antic and the Display List 



c Mode 


Basic Mode 


Mode lines/ 
■full screen 


Scan lines/ 
Mode line 


Bytes 
node 


2 


0 


24 


8 


40 


3 


none 


19 


10 


40 


4 


none 


24 


8 


40 


5 


none 


12 


16 ' 


40 


6 


1 


24 


8 


20 


7 


2 


12 


16 


20 


a 


3 


24 


8 


10 


9 


4 


48 


4 


10 


10 


5 


48 


4 


20 


n 


6 


96 


2 


20 


12 


none 


192 


1 


20 


13 


7 


96 


2 


40 


14 


none 


192 


1 


40 


15 


8 


192 


1 


40 
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DISPLAY LIST 

In order to implement a Display List Interrupt, there are -four stpps 
that must be completed: ~ p ~ 

I. Decide where on the screen the interrupt should occur, and set 
the Interrupt enable bit o-f that line of the Display List. 

2 Write the Assembly Language code that is to be executed during 
the interrupt, and place it in memory. 

3 Tell the computer where the routine is located by point ina the 
DLI vecLor to the code's location in memory. 

4 .Enable Display List Interrupts by setting the proper bit in the 
Interrupt Mask location. 



ERING -THE DISPLAY LIST 

_ To c ause a DLI on a specific mode line of the Display List, add 
Lc to the mode line's value. As an example, to cause a DLI on the 5th 
line o-f a Graphics 0 screen, find the 5th mode line in the Display 

112 blank 8 lines 

112 blank 3 lines 

112 blank 3 lines 

06 use graphics 0, start memory at 

64 low byte o-f screen F:AM address 

156 high byte of screen RAM address 

2 2nd GR 0 line 

2 3rd 

2 4th 

2 the 10th number in the Display List is mode line 5 

Add 128 ( set the highest bit ) to the 2 from this line to pet 

Poke this 130 back into the Display List, and when the DLI is enabled. 

it will occur on this line of the screen. 



/ 



i 



WRITING THE I NTERRUPT CODE 

-4 ^!i S f lay ^ L i St Interru P t Assembly code must be fairly short because 
of tame limitations. Because the subroutine may be called at anv tilt 
any registers that are affected by the routine must first bj -aCed and 
^ Q r f! tQr f d before leaving the routine. This is commonly done by 
using the stack and the instructions PHA and PL A. If the X or Y 
PhT »Z neede ?: use the TXA °r TYA commands in conjunction with the 

t"y it iT'Zlt I** PrOCe f S reSt ° re * Y "=^9 PLA and TAX or 
i«Y. It is best to use only the Accumulator if possible. The rmtin- 
should end with the Return From Interrupt command - F:Tl Do o °"U 
th« R,S command. If you do not want the changes you make to take 
effect until the end of the scan line being drawn on the TV \ U5t 
include the command ST A WSYNC, where WSYNC = 54282. Any value in tit 

ofTsr-ohi-:^ 1 ' 0 th % J '° b : — DL^urnl^hrbotto. 

?s uJd"?^ U H scree ". to P lnk - < the X register needn't be used, but 
is used for demonstration purposes ): ' ut 

PH A save accumulator 
TXA 

PHA save X reaister 

LD^ Ir2 ^J 1 make " the characters dark ( 0 luminance) 

ll?a #63 color pink 

I™ ( / SYN S changes until end of line 

cIS S !° re dark chfirs in hardware reaister 

STX store pink in background hardware reaister 

FLA 

TAX restore X register 

PLA restore Accumulator 

RTI Return From Interrupt 

" !! + imP ° rt ;j t *° under5t *nd the concept of Hardware and Shadow 

it is dofr n n -r'd the draWinQ °* ^ TV th * ™put«- 

stops what it is doing and copies several shadow reaister values back 

into corresponding hardware registers. An example of this is the co or 

registers. A value POKED into 708 will be moveS to 5327 at » 

wfn r^T' HlS : e f nS thSt " the P^ram chanaes 708, the ^ = 
will not be seen until the end of that screen. Al'so, the effects wil' 

t^?™*^'**^** the computer will keep moving 708>s value into 

to^end -I *h h' i^; OU ^ 5 Chan9e to t&ke Dl *ce immediately? and 
to end *t the end of the screen, you must make your changes to the 
hardware registers, (in this case, to 57:270) 9 tD the 
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the: r>i_i vector 

Once your code is written and stored safely in RAM. you must tell 
the computer where it is located. There are two locations which form a 
vector which identifies this RAM location. Locations 512 and 517: < he - 
92oo and *201) are the low and high bytes, respectively, which can be' 
combined to represent any Atari RAM location. For example, if your 
code was located at the beginning of page six in memory (starting at 
he:: location $0600), the two bytes would be as follows: 



512 = 0 

513 = 6 



the low byte 
the hiah byte 



If your code was stored at location 35000 in RAM. you would calculate 
the values for 512 and 513 by dividing 35000 by 256: 

is the quotient (high byte) 



136 

256 ) 35000 
256 



9400 
76S 

1720 
1536 



512 
513 



184 

184 

136 



1 s 



the remainder (low byte) 



ENABL ING YOUR: Ol_ I 

After completing the three previous steps, you are ready to enable 
your Displav List Interrupt. To do so. all that is required is one 
poke into location 542S6. The following will do the the job: 

From Basic: POKE 54286 , 1?2 

From Assembly: LDA #$C0 

STA SD40E 

To disable the interrupts, poke the same location with 64 (S40) . 
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VERT I BLf^tNJK INTERRUPTS 



j. if*!"* 1 "* Blank Interru Pt routine is executed after each drawino 

of the televxsion screen (60 times a second). During a VBI the 
programmer can execute as many as 5,000 machine language commands 
^ Sre / r ! SeVeral advantaces to being able to execute this much code in 
this fashion. Because the TV screen is not being drawn during s VBI 
any changes to screen RAM or to PI ayer /Mi ssi 1 e Graphics will not be ' 

!!I?-,h?? 1 ^J-*t n *- t drawing ° T ' the ==reen. This can eliminate some 
unsightly -flickering, and allow for smooth full-screen scrollina In 

■?r*?:X".i! BI * * r * more complicated than Display List Interrupts." an£ 

^-t^^^f ??"?r hat ? aS r r tQ USS - 11 15 im P*rtant to understand 
wh„t goes on „t the end of each TV screen's drawing be-fore attempting 
•-u write and use a VBI. - 

reai ri h ?n*?? °^ + th ! ^[ een the com P uter the A, X. and Y 

registers on the stack (this means you will not have to do this 
yourself , and goes to the Immediate Vertical Blank Routine. It finds 
^H/? Utl r e bY USing thS VeCt ° r at ^cations S222 and S223. D v 
™! - It tlons P° int to * n Operating System routine located at 4 

irtt IL T H° UtinS tHat C ° PleS thS COl ° rS < rom the »h.dow Bg s t er f" 
c'ock Itr 3 re ^ sters « re * ds ^e joystick, increments the system 

e sc ^ T r iL-?-i ln ; ^ inde, - ect J««P command through 

Xrtic-i p OC r ted St 3224 and $225 ' This P°ints to the Defered 

Sii-llv ^} n# ' the . COmmar > d in Assembly language is J MP 

""I U»u«lly this vector points to a small routine at $E46~ that 

restores A. X. and Y and does an RTI. *t*6_ tn«t 

Th* Jon m ° St P " rPOS5S ' thS ^"^ed VBI is the time to run our code 
The steps to set up this VBI are: coce. 

1. Write the code and store it memory. 

2. Change the vector that points to the Deferred VBI. 
^ /<s ._I^ VO ". deSi r! to have vour ccde executed before the Ooerati-o 



If 



THE CODE 



Write Assembly code -for the task you want to accomplish, and place 
it in RAM. The only restrictions are the length o-f time your code 
takes to run (20,000 machine cycles - see Levanthal's 6502 book -for 
cycle counts), and in the way the code must end. Your last statement 
must be a JMP SE462. This. will restore the registers and do the RTI. 
Your code will not execute until the vector at S224 and S225 is pointed 
to its location in RAM. 



HE VECTOR 



The De-f erred VBI vector must be chanced very care-fully. 1+ only 
one o-f the two bytes is reset to the desired location, then the address 
contained in the vector. is innaccurate, and should the interrupt occur 
ar this point, the computer will go to the wrong location in memorv to 
rind the code. Chances are good you will crash the machine. The 
vector must be changed quickly (not -from BASIC) and at a sa-fe time in 
the drawing o-f the TV screen. The Operating System has just the 
routine to do the job, but it must be called from Assembly lanauage. 
To use the routine, load the low byte c-f your code's location into the 
Y register. Next, load the high byte o-f the location into the X 
register. Now load the accumulator with a 6 -for a immediate VBI, or a 
7 .or a deferred VBI. Finally, do a Jump-Subroutine to SETVBV (SE45C) 
Following is an example which sets the vector to point to a routine 
located at the beginning o-f page six ($600) which is to be executed in 
the de-f erred VBI: 



LDY #0 low byte o-f address 
LDX #6 high byte o-f address 
LEA #7 means de-f erred VBI 
JSR SE45C change the vector 



You will probably need to modi-fy 
USR -function in BASIC. 



this routine to be used -from the 
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TH E USR COMMAND 



run tho SIC S JJ OWS you to write assembly language programs *nd 
run the resulting machine language routines usina the USP 
command. The command -follows the -format: " 

ft = USR < address , paraml , param2 , . . . ) 

Ire TocaJlS i = f^" Y "J*™ th * Mchlni l^guage instruction- 
co c located is the -farst number after the le-ft parenthesis 
xt is optional to then include 1, 2, or more other values 
betore the right parenthesis. These optional numbers c" be 
us.d to pass information into the machine language routine 
The variable A may contain a value returned by the Echini' 
language routine, if the programmer so desires. Tbii SS^.. 
and optional parameters may be constants or variable* ar3" 

^t-^ijf integers by basic - The >' — - - 

routi^r^t^Ive!^: A 0n x r0l - r d°T "° T 1 

the stac, the addresl in Jd/SSs C^de^whTch VtT^Tt 

^a^en rnrp^^^Zt^^nt.e^bl-^r "T^ Thi5 ^ 
least one number'off 0^1^^^^^^^ 
Failure to do so will cause BASIC to return to I S^'hh 

? 0 ZXt" r r rih e 15 d0n& " ^ d "V Je'ry tin ? I" 

o C ;. c n ^ S 5S : ,e wav > " Pull too manv numbers off 

careful N ' * ddress * 1 also be invalid.' Be 

L f Bfu1, and lT > /our routine crashes the sv=t=m 1 -i-i- - + 
stack pulling as a first possible cause! ? ° -t V ° Ur 



For a sample program, assume we wanted to use the =peed 
of machine language to search the screen to count the number 
of occurences o-f any character we choose. Because we want 
our routine to be versatile, we want to be able to specify 
where in RAM our screen begins ( in case o-f different RAM 
sizes, or multiple screens). This would mean we will need 
two parameters: The RAM location at which to begin, and the 
ch&racter which we are counting (we will have to pass the 
internal code number which represents our character). The 
routine itself will compare every byte o-f screen RAM and 
return the count in our variable to the le-ft o-f the " = " in 
our USR call. We will store our routine in page six o-f 
memory (beginning at decimal location 1536) and we will hav= 
to use several page zero memory locations for our pointers 
and calculations. In BASIC we may use locations 203 throuoh 

l''!' h 0 " 110 "; 21 E * nd 213 * r5 to return the value from 

uhe U=r. command. Our program is on the next paqe. (The onlv 
important thing to understand is how to pull your parameters' 

ZV** * nd SSVe them " and how to return a value to 

BmSIC and leave the subr outine. Don't worry about the loqic 
o-f the counting routine.) " 

(As a final note, always save any prooram usino USR 
berore running it. There are so many things that can go 
wrong, you can afford the minute it takes to save your work.) 

To call our routine, use the command: 

COUNT = USR < 1536 , 40000 , 10 ) 

This call searches the screen beginning at 40000 in RAM for 
the character »*•'. See page 55 of the BASIC Reference Manual 
tor character numbers. 40000 is usually the beginning of 
screen RAM in a 48K system after pressing the System Res^t 
Key. 



, X>0 
1010 
1 020 
1030 
1040 
1 050 
1 060 
1070 
1 080 
1 090 
1 100 
1110 
1120 
1 1 30 
.1140 
1 1 50 
1 1 60 
1 1 70 
1 1 80 
1190 
1200 
1210 
1220 
1230 

1 260 
1270 
1 280 
1 290 
1300 
1310 



1330 

1340 
i 350 

1 360 
1370 
1380 
1390 
1 400 



COUNT = USR ( 1536 , SCR-RAM-ADR , CHAR-MUM ) 



COUNT 

POINTER 

CHAR 



. — ^ 2 

= 203 
= 205 
♦=50600 



INIT 



PLA 

PLA 

STA 

PLA 

STA 

PLA 

PLA 

STA 

LDA 

STA 

STA 

LDX 



POINTER+1 
POINTER 



CHAR 
#0 

COUNT 

COUNT+1 

#4 



LOOPS I G LDY #240 

n 

LOOP 



Return value -from USR command 

Used -for Indirect, Indexed Addressinq 

b«ving the character we're looking -for 

Number o-f parameters - should be 2 
High byte o-F screen RAM address 
High byte stored second 
Low byte o-f screen RAM address 
Low byte stored -first 

Char high byte should be zero - ignore 
Char low byte 



Both bytes o-f return value 
set to zero 

We are going to search counting 

4 times 240 = 960 bytes per screen 



LDA (POINTER) , Y Get each character 
CMP CHAR is it the kin<J we COL(ntinQ? 



SKIP 



1410 
1 420 
1430 
1 440 
1 450 
1 460 
1470 
30 



BNE SKIP 

LDA COUNT 

CLC 

ADC #1 

STA COUNT 

LDA C0UNT+1 

ADC #0 

STA C0UNT+1 

I NY 

CRY #240 
BNE LOOP 



It not then move on 

I-f it is. then add 
byte o-f our COUNT 
Use the Carry bit to alter 
high byte o-f our count, i-f 



one to the low 



the 

neccessary 



i5l0 
1520 



LDA POINTER 
CLC 
ADC 
STA 
LDA 
ADC 
STA 
DEX 
BNE 
RTS 



#240 
POINTER 
P0INTER+1 
#0 

P0INTER+1 
L00PBIG 



Next character location 

Up to 240, then we have to alter 

our pointer to Screen RAM 

Add 240 to the low byte, and -fix 
the high byte using the C&rry Bit 



Count down until we have done it. 
Four times, and then Return to BASIC 
1 o30 . END 



ATAR I 1020 f=R INTER 



First o-f all, open the printer: 

OPEN #1,8,0, "P: " 

To get into GRAPHICS mode: 

PRINT #l;"(ESC> (ESC) CTRL G" 

To return to TEXT, mode: 

PRINT #l; "A" 

THE FOLLOWING COMMANDS ARE GIVEN FROM THE TEXT MODE 
To get 20 characters per line: 

C PRlNT #1 '"<ESC) (ESC) CTRL P« 

To get 80 characters per line: 

PRINT #1,"< ESC) (ESC) CTRL s „ 

To get b ac, to 40 characters per line; 

PRINT #1 ? »(ESC) (ESC) CTRL N» 

To change the SCALE of the letters: 

PRINT #1 

T ° «« SS the INTERNATIONAL character „ t; 

PRINT •„.««, (ES c, CTRL W 

I retUrn *° thS ST «^™ character set: 

print mu-taa (ESC) CRTL 



THE FOLLOWING COMMANDS ARE GIVEN FROM THE GRAPHICS MODE 
To return the pen to the HOME position: 

PRINT #1; »H" 

To specify the pen COLOR: 

m'ET # i 5 "? (a Value 0 to 3) 

<0=black, l=blue, 2=grsen, 3=red) 

To specify the LINE TYPE: 



PRINT #l;^L(a number from 0 to 15) 

>es) 



(0 t. a solid line, 15 is dots , and 7 - s dash{ 



To INITIALIZE the printer Qr +k 

P ter ' or set the current position as 0,0: 

PRINT #l; "I" 

^pjo DRAW to a specific point: 

PRINT #1| "Dx,y" 

(x is a value from 0 to 480, and y is f rom -999 to 999) 

To DRAW RELATIVE to your current position: 

PRINT #1; "Jx,y» 

(x and y are' the same as for DRAW) 

To MOVE to a specific point: 

PRINT #1| "Mx,y" 

To MOVE RELATIVE to your current position: 

PRINT #1; "Rx,y" 

To draw a Y AXIS: 

PRINT #1;"X0, distance between tics, number of tics" 



to 



To draw an X AXIS: 

PRINT #l;"Xl, distance between tics, number o-f tics" 



To ROTATE the text by 90 degrees: 

PRINT #l;"Q(a value -from 0 to 3) 

<0 is normal, one is down, etc. clockwise) 

To repeat the same command in one PRINT statement: 

Do not repeat the code letter, 

and separate the values with a ; 

ex. PRINT #1| "D10, 10? 30, 30; 100, -100" 



To give successive commands in one PRINT statement: 

Separate the commands with a * 
ex. PRINT #1; "C2*M10, 20*D100, 100" 



^Wherever the phrase "a value from 0 to #" appears, either an inteaer 
[ -value or a variable may be used in the PRINT command. lr >teger 



// 



